TIME_UP

  .  Summary

  time_up(int <thandle>);

  .  Description

  The timer functions are used to set and keep track of a timer vari-
  able.

  The time_up function returns a non-zero (TRUE) value if the timer
  represented by timer handle <thandle> has elapsed, otherwise a 0
  (FALSE) value is returned. The period of time after which a timer
  will elapse is specified in the timer_start function.

  .  Return Value

  time_up returns a non-zero (TRUE) or 0 (FALSE) value depending on
  whether a timer has elapsed or not.

  .  Example

  int t;

  t = timer_start(100);    // delay for 10 seconds
  while (!time_up(t))
   ;
  timer_free(t);

  // start a timer and loop forever, printing the elapsed time
  // in tenths of seconds
  t = timer_start(0);
  while (1)
   {
    printn(timer_total(t));
    prints("");
   }